/**************************************************************************(C)*
 *
 *  This file is part of the GreenHills project
 *  Copyright (C) 2009  Tieto Corporation
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  Not for commmercial use. Only with Tieto permission.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 *************************************************************************(C)*/

#pragma once

#include "iodll.h"

namespace greenhills {
namespace io {

    class CConnection;

    /**
     * @brief This interface should be implemented by all classes that
     * have to be informed about newly received data.
     *
     * @author Alexander Nikolskiy (alexander.nikolskiy@tieto.com)
     */
    class GH_IO_CLASS IDataListener
    {
    public:
        /**
         * @brief Listeners have to implement this method in order to
         * be notified about data that have been received.
         *
         * @param pData Pointer to the received data.
         * @param pLength Length of the received data.
         * @param pConnection Pointer to the connection object which sent the
         * data received event.
         */
        virtual void dataReceived(const char *pData,
                                  unsigned int pLength,
                                  CConnection *pConnection) = 0;
    };

} //namespace io
} //namespace greenhills
